home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Taifun / Taifun 263 (1993-12-10)(Manewaldt, A.)(DE)(PD).zip / Taifun 263 (1993-12-10)(Manewaldt, A.)(DE)(PD).adf / DiskSalv2 / DiskSalv.doc < prev    next >
Text File  |  1993-12-04  |  47KB  |  1,057 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.            DDD  III SSSS K  K SSSS   A   L  V   V      222 
  19.            D  D  I  S    K K  S     A A  L  V   V         2
  20.            D  D  I  SSSS KK   SSSS A   A L  V   V        2 
  21.            D  D  I     S K K     S AAAAA L  V   V       2  
  22.            D  D  I     S K  K    S A   A L   V V       2   
  23.            DDD  III SSSS K  K SSSS A   A LLLL V        2222
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                The Original Amiga Disk Salvage Program
  35.  
  36.  
  37.               Recovering your data for over seven years
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                             Cheap Manual 
  49.                                  for 
  50.                               DiskSalv 
  51.  
  52.                               Version 2
  53.                             Revision 11.28
  54.                            October 11, 1993
  55.  
  56.                  Copyright ©1992, 1993 by Dave Haynie
  57.                          All Rights Reserved 
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. COPYRIGHT 
  70.  
  71.           This  manual  is  Copyright  ©1992, 1993 by Dave Haynie. All
  72. Rights Reserved.  As part of the DiskSalv2 11.28 release, this  manual
  73. may  be  used  in  electronic or printed form along with the DiskSalv2
  74. program.  It may not be sold in any form, though a reasonable  copying
  75. and  handling  charge is acceptable, as long as the complete DiskSalv2
  76. distribution is included.  
  77.  
  78.  
  79. DISCLAIMER 
  80.  
  81.           The information and the DiskSalv program  are  provided  "as
  82. is" without  warranty  of  any kind, either expressed or implied.  The
  83. entire risk as to the accuracy of the information herein is assumed by 
  84. you.   Dave  Haynie  does  not  warrant,  guarantee,   or   make   any
  85. representations  regarding  the  use of, or the results of the use of,
  86. the information or the  DiskSalv  program  in  terms  of  correctness,
  87. accuracy, reliability,  currentness,  or  otherwise.  In no event will
  88. Dave  Haynie  be  liable  for   direct,   indirect,   incidental,   or
  89. consequential  damages resulting from any defect in the information or
  90. the DiskSalv program even if he has been advised of the possibility of 
  91. such damages.  
  92.  
  93.  
  94. CREDITS 
  95.  
  96.           This manual was prepared with anro, an nroff-like utility by 
  97. Steve Anderson. With all the sophisticated word processors and DTPs  I
  98. have  around,  I couldn't find anything that would simply give me some
  99. formatted ANSI text.  Until everyone has a way to deal with  IFF-FTXT,
  100. ANSI  will  remain  the only printer independent formatted text format
  101. available.  
  102.  
  103.           Amiga, AmigaDOS, Intuition,  KickStart,  and  Workbench  are
  104. trademarks of Commodore-Amiga, Inc.  
  105.  
  106.           The  DiskSalv  program,  its code, this manual, the DiskSalv
  107. icons, and  anything  else  distributed  with  this  package  are  the
  108. original  work  of  Dave  Haynie. Thanks go out to the Commodore-Amiga
  109. Software Engineering group for suggestions on  the  DiskSalv  GUI  and
  110. other Amiga  software  standards.    Countless  others  assisted  with
  111. suggestions, testing, and miscellaneous feedback which has also proved 
  112. invaluable.  
  113.                              -Dave Haynie
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133. DiskSalv Version 2 Release 11.28                                Page 3
  134.  
  135. 0. INTRODUCTION 
  136.  
  137.           DiskSalv Version 2 is a disk recovery program for all  Amiga
  138. file  system  devices  that  use any of the 2.04/2.1/3.0 file systems.
  139. DiskSalv will scan (analyze) a bad disk volume for anything  that  can
  140. be recovered, and will restore these items to any AmigaDOS volume.  It 
  141. can   also   attempt   to  fix  a  bad  volume  in  place  under  most
  142. circumstances.   DiskSalv  is  a  complete  redesign  of  the  orignal
  143. DiskSalv  program,  with  a  new  AmigaDOS-2.0-compliant  command-line
  144. interface, new Intuition interface, and tons of new features.  
  145.  
  146.           This is designed to be a fairly  complete,  quickly  written
  147. and minimally  edited  manual  of  DiskSalv Version 2's features.  The
  148. built-in help system works as an adjunct to this, and it works  simply
  149. --  press the HELP key with the mouse positioned over something, and a
  150. short description of that something will pop up in a requester.  
  151.  
  152.           Better documentation is planned, but it won't be free.   I'm
  153. currently  working  on  a  professional  quality manual with pictures,
  154. better "how to", "why bother", and "theory of it all"  sections.    Of
  155. course, the  operative  phrase  here is "currently working".  It ain't
  156. done yet.  I hope to complete it by the time I do a general  shareware
  157. release.   Since  it will be several megabytes of PostScript output by
  158. the time its done, and I really  have  no  philosphical  objection  to
  159. making  a little beer money here and there, this will be offered up as
  160. a printed manual as part of a  semi-commercial  version  of  DiskSalv.
  161. This  is  all  explained  in the "Licensing and Distribution" section.
  162. Additionally, the core  of  that  manual  will  become  an  AmigaGuide
  163. manual, and that will come with the printed version.  I just figured I 
  164. would  mention  this  all here before confusing you with the quick and
  165. dirty version to follow.  
  166.  
  167.  
  168. 1. STARTING UP 
  169.  
  170.           DiskSalv Version 2 (from here on referred to as  "DiskSalv")
  171. is a  program designed to "salvage" damaged hard disks.  There are two
  172. basic   classes   of   salvage   operation,   "Recover-by-Copy"    and
  173. "Fix-in-Place".  In  the  former  case,  DiskSalv  analyzes a disk and
  174. attempts to restore any files and directories from a damaged  AmigaDOS
  175. file system  device  to  a  good  one.    In the latter case, DiskSalv
  176. attempts to find faulty disk objects and remove them from  the  disk's
  177. directory/file  hierarchy  so that the disk's FileSystem will validate
  178. it.  
  179.  
  180.  
  181. 1.1 CLI OPERATION 
  182.  
  183.           In the simplest case, DiskSalv can be used  very  much  like
  184. DiskSalv  V1.42,  the  AmigaDOS  "DiskCopy"  program, or any number of
  185. other CLI-based programs.  The user simply  types  a  command  at  the
  186. command line,  and  the program goes to work.  For example, to recover
  187. files from a bad disk in DH0: and restore them on a  good  disk  DH1:,
  188. the user will type: 
  189.  
  190.           1> DiskSalv FROM DH0: TO DH1: 
  191.  
  192. Here the "FROM" and "TO" required CLI keywords.  There are quite a few 
  193. more  keywords,  which control a good portion of DiskSalv's operation.
  194. However, to access every feature, it's necessary to  use  the  program
  195. interactively  under  Intuition. The AmigaDOS template is displayed as
  196.      follows: 
  197.  
  198.  
  199. Page 4                                DiskSalv Version 2 Release 11.28
  200.  
  201.      DiskSalv Version 2 Copyright (c) 1991-1993 by Dave Haynie
  202.  
  203.      FROM/K, TO/K, MODE/K, FILESYSTEM/K, DEFAULTFS/K, TAGCHAR/K,
  204.      PUBSCREEN/K, MEMCHUNK/N, PATHMAX/N, DISKCACHE/N, LOWMEM/S,
  205.      NOSIZECHECK/S, QUICKSCAN/S, NOWARNING/S, NODATES/S, NONOTES/S,
  206.      NOPROTECT/S, KEEPDOS/S,KILLDOS/S, NODEEPSCAN/S, INTERACTIVE/S,
  207.      REJECTION/N, MAKELINKS/S,S MALLWINDOW/S, BIGBLOCKS/T, LOADDEV/K,
  208.      RETRY/N
  209.  
  210. The meaning of these keywords is given below.  Note that  any  keyword
  211. can also be used as an icon variable (tooltype).  
  212.  
  213.      FROM 
  214.           The  "FROM"  keyword  specifies  an input device, the device
  215.           that will be operated on.  This must be a DOS device, not  a
  216.           subdirectory  or  assignment, and it must be based on one of
  217.           the standard file systems with underlying device driver.  
  218.  
  219.      TO 
  220.           The "TO" keyword specifies an output device, the device that 
  221.           will receive any recover-by-copy files that DiskSalv  finds.
  222.           This  may  be  any AmigaDOS device, volume, or subdirectory.
  223.           If a non-existant subdirectory is  specified,  one  will  be
  224.           generated.  
  225.  
  226.      MODE 
  227.           There  are  several  kinds  of  functions that DiskSalv will
  228.           run.  The default is "Salvage",  which  causes  DiskSalv  to
  229.           work  just  like  the  original  DiskSalv. Other modes cause
  230.           other actions: 
  231.  
  232.      SALVAGE 
  233.           This is  the  basic  Recover-by-Copy  function.     DiskSalv
  234.           attempts  to  restore  every  file  it  finds from the input
  235.           device to the output device.  The user can select the  files
  236.           to actually restore.  
  237.  
  238.      UNDELETE 
  239.           This is  another  Recover-by-Copy  function.   It is used on
  240.           undamaged partitions to find deleted files.   The  user  can
  241.           interactively pick which files are actually restored in this 
  242.           way.  
  243.  
  244.      VALIDATE 
  245.           This is the simplest Fix-In-Place function.  It can repair a 
  246.           device that  hasn't been severely damaged.  On most devices,
  247.           the scan used in this mode is much faster than other  scans,
  248.           but it  can  slow  down  on very large volumes.  As with all
  249.           Fix-In-Place functions, any file  that  must  be  eliminated
  250.           from  disk  will  be  displayed  in a file list once the fix
  251.           operation has completed.  
  252.  
  253.      REPAIR 
  254.           This is a more advanced Fix-In-Place function.   It  does  a
  255.           traditional  DiskSalv  scan, and it can find more files than
  256.           the Validate function can.  It can also live with partitions 
  257.           that are more damaged than those Validate will handle.  
  258.  
  259.      UNFORMAT 
  260.           This function runs a Fix-In-Place operation on a  disk  that
  261.           has      been      accidently      formatted      (hopefully
  262.           non-destructively).  It's similar to Repair, but it  assumes
  263.  
  264.  
  265. DiskSalv Version 2 Release 11.28                                Page 5
  266.  
  267.           that the disk root is invalid.  
  268.  
  269.      FILESYSTEM 
  270.           This  allows  the  user to specify the file system to use on
  271.           the input device.    Normally,  DiskSalv  will  determine  a
  272.           partition's file  system  from  its root block.  If for some
  273.           reason that information is unavailable or wrong, this allows 
  274.           the file system type to be specified by force.  
  275.  
  276.                OFS 
  277.                     Original AmigaDOS FileSystem.  
  278.  
  279.                FFS 
  280.                     1.3-compatible Fast FileSystem.  
  281.  
  282.                OFS Intl.  
  283.                     International character set aware version of  OFS.
  284.                     International   file   systems  treat  diacritical
  285.                     characters  properly  with  respect  to  the  case
  286.                     independence expected in an Amiga file system.  
  287.  
  288.                FFS Intl.  
  289.                     International character set aware version of FFS.  
  290.  
  291.                DC-OFS 
  292.                     Directory   caching   version  of  OFS.  Directory
  293.                     caching  file  systems  keep  a  secondary  packed
  294.                     record  of  file  data  to  provide fast directory
  295.                     listings.  
  296.  
  297.                DC-FFS 
  298.                     Directory caching version of FFS.  
  299.  
  300.                Best-Guess 
  301.                     DiskSalv will pick one of the FileSystems it knows 
  302.                     about, based on  an  analysis  of  the  disk  done
  303.                     during the Scan. This is the standard default file 
  304.                     system  (eg,  default  if  no alternate default is
  305.                     selected).  
  306.  
  307.      DEFAULTFS 
  308.           This allows the user to specify the fallback  FileSystem  to
  309.           use on  the input device.  Normally, DiskSalv will determine
  310.           a partition's FileSystem from its root block,  but  if  that
  311.           root block is damaged, DiskSalv needs this fallback.  
  312.  
  313.      TAGCHAR 
  314.           This  allows  the user to specify which character to use for
  315.           tagging selected files on the Output  screen  file  browser.
  316.           The default is '*'.  
  317.  
  318.      PUBSCREEN 
  319.           This  specifies  the  public screen for DiskSalv to start up
  320.           on.  If none is specified, DiskSalv will  start  up  on  the
  321.           Workbench screen (eg, default public screen).  
  322.  
  323.      MEMCHUNK 
  324.           This  specifies  the memory chunk size for DiskSalv's chunky
  325.           allocator to use.  By default, this is 4K, and  can  be  set
  326.           between 1K and 128K.  
  327.  
  328.      PATHMAX 
  329.  
  330.  
  331. Page 6                                DiskSalv Version 2 Release 11.28
  332.  
  333.           This specifies  the  maximum  length  of  a  file path.  The
  334.           default value is 512 bytes, and can be set between 256 bytes 
  335.           and 4K.  
  336.  
  337.      DISKCACHE 
  338.           This specifies the number of blocks to be used for the  disk
  339.           cache (which  is  actually a pre-fetch buffer).  The default
  340.           size is 8 blocks, and can be set between 0  (no  cache)  and
  341.           255 blocks.  
  342.  
  343.      LOWMEM 
  344.           This specifies  low-memory  mode.    If DiskSalv runs out of
  345.           memory on a system in normal mode, it may be  successful  in
  346.           low-memory mode.    This  automatically  causes  the  chunky
  347.           allocator, file path buffer, and disk cache to go to minimum 
  348.           sizes.  It cuts out a number of other internal  things  that
  349.           generally just affect performance rather than success.  
  350.  
  351.      NOSIZECHECK 
  352.           This  inhibits automatic size checking of the output volume.
  353.           Normally, DiskSalv watches the size of the output volume  to
  354.           have an idea ahead of time that a volume will fill up.  Some 
  355.           devices,  such  as  RAM:,  are  dynamically sized and always
  356.           indicate full  when  asked,  so  this  parameter  is  mainly
  357.           intended  for  such  devices (DiskSalv actually invokes this
  358.           automatically for RAM:, but it would have  to  be  specified
  359.           manually for other such devices).  
  360.  
  361.      QUICKSCAN 
  362.           This specifies  a faster disk scanning mode.  The speed of a
  363.           disk  scan  is  improved  by  cutting  down  on  the  visual
  364.           display.   DiskSalv will still show a "gas-guage" indicator,
  365.           but it won't list objects as they are encountered.  
  366.  
  367.      NOWARNING 
  368.           DiskSalv will normally attach a warning or error message, as 
  369.           a FileNote, to any file it restores  via  a  Recover-by-Copy
  370.           operation that  it  considers  suspect  or bad.  This option
  371.           will inhibit such action.  
  372.  
  373.      NODATES 
  374.           This option will inhibit restoration of  the  original  file
  375.           date in Recover-by-Copy operations.  
  376.  
  377.      NONOTES 
  378.           This   option  will  inhibit  restoration  of  the  original
  379.           FileNote in Recover-by-Copy operations (though warning notes 
  380.           will override original notes).  
  381.  
  382.      NOPROTECT 
  383.           This  option  will  inhibit  restoration  of  the   original
  384.           protection codes in Recover-by-Copy operations.  
  385.  
  386.      KEEPDOS 
  387.           The FileSystem (eg, AmigaDOS) is usually locked out from the 
  388.           input device  during  scan  and  recovery  operations.  This
  389.           option will prevent such a lockout.  Fix-In-Place operations 
  390.           are not affected by  this,  as  they  absolutely  require  a
  391.           FileSystem  lockout since they are modifying the input disk.
  392.           Note that allowing any writes to the  input  disk  during  a
  393.           DiskSalv  operation  will almost certainly cause DiskSalv to
  394.           malfunction.  
  395.  
  396.  
  397. DiskSalv Version 2 Release 11.28                                Page 7
  398.  
  399.      KILLDOS 
  400.           This option forces DiskSalv to do its job without using  any
  401.           device  directed  DOS  functions  or  file  system  packets.
  402.           Normally, DiskSalv uses a handfull of DOS library  functions
  403.           on input  disks.  This is designed to make DiskSalv safe for
  404.           use on disks that crash  AmigaDOS  or  the  particular  file
  405.           system in  use.   This is a somewhat dangerous option, since
  406.           it prevents DiskSalv from locking the file system out  of  a
  407.           device (since that requires a file system packet).  It works 
  408.           best  on  devices  that  can't  be given to AmigaDOS because
  409.           they're too damaged.  Note that DOS is automatically avoided 
  410.           on unmounted devices.  
  411.  
  412.      NODEEPSCAN 
  413.           This inhibits extra low-level  processing  from  being  done
  414.           floppy disks.  Such processing can recover data not normally 
  415.           accessable through the trackdisk.device, but it causes extra 
  416.           memory to be used.  
  417.  
  418.      INTERACTIVE 
  419.           This  forces  DiskSalv  into  interactive  operation (eg, it
  420.           waits for user input).  When run from the CLI, DiskSalv will 
  421.           by default do as much as  it  can  non-interactively  before
  422.           going into interactive mode.  
  423.  
  424.      REJECTION 
  425.           This  specifies  a  filter  strength, between 1 and 10, that
  426.           influences DiskSalv's assessment of whether or  not  a  disk
  427.           block matches a specific block type.  This is generally left 
  428.           at the default, 6.  
  429.  
  430.      MAKELINKS 
  431.           This  causes DiskSalv to actually create links on the output
  432.           volume.  Normally it instead creates  a  script  file  which
  433.           will create the links.  
  434.  
  435.      SMALLWINDOW 
  436.           This  causes  DiskSalv  to  build a minimal scanning display
  437.           window, even on large screens.  
  438.  
  439.      BIGBLOCKS 
  440.           This lets the user specifiy  whether  support  for  multiple
  441.           sectors per   block   is   enabled.    On  pre-V39  systems,
  442.           occasionally DOS devices claimed for  some  reason  to  have
  443.           more than  one sector per block.  Since real support of this
  444.           didn't appear until the  V40  FileSystem,  which  apparently
  445.           needs  V39  to run, multiple sector per block support is off
  446.           by default in on a pre-V39 system, on  by  default  for  V39
  447.           systems and above.  
  448.  
  449.      LOADDEV 
  450.           This  argument  takes  the  name  of a DOSDrivers-compatible
  451.           device description file, which it will load and set  as  the
  452.           current input device.  
  453.  
  454.      RETRY 
  455.           This  argument  changes the number of retries a device drive
  456.           will run on a read failure.  USE THIS OPTION  WITH  CAUTION!
  457.           This  function  uses  the convention of the trackdisk.device
  458.           for retry count, which isn't guaranteed to be  supported  by
  459.           other device  drivers.   In general, the default retry count
  460.           is what you want to use.  When a device has a  large  number
  461.  
  462.  
  463. Page 8                                DiskSalv Version 2 Release 11.28
  464.  
  465.           of  errors,  it can be processed much faster by setting this
  466.           parameter as low as zero, if the  selected  device  supports
  467.           this convention.    If  not,  there's a chance it will cause
  468.           some unknown problem, so it's best to use  only  as  a  last
  469.           resort.  
  470.  
  471.  
  472. 1.2 WORKBENCH OPERATION 
  473.  
  474.           DiskSalv can be run from the Workbench by double-clicking on 
  475. its  Icon.  Normally,  this  brings  up  DiskSalv interactively, where
  476. options are set via standard 2.0-level  Intuition  interface  objects.
  477. However,  any  of  the  command-line  parameters  may  be  set as Icon
  478. ToolTypes  to  set  DiskSalv  up   for   other-than-standard   default
  479. conditions and other special things.  
  480.  
  481.  
  482. 1.3 THE DISKSALV GUI 
  483.  
  484.           No  matter  how  you enter DiskSalv, you're going to wind up
  485. seeing some aspect of the program's  GUI.  If  you  run  interactively
  486. either  from  the  CLI  or  from  Workbench, you will start out in the
  487. "Input Window". Here is where various parameters are set that  control
  488. how the program will "scan", or learn about, a given input disk.  Once 
  489. all  input  information  is  set  up,  the  program moves to the "Scan
  490. Window",  which  basically  monitors  disk   scan   and   Fix-In-Place
  491. operation, where  applicable.  If it's appropriate (files are found in
  492. a  Recover-by-Copy  mode  or  damaged  files  are   found   during   a
  493. Fix-In-Place  operation), the Scan Window will give way to the "Output
  494. Window". This windows accepts input to select the objects that will be 
  495. restored and the device to restore them to.  
  496.  
  497.           While DiskSalv's interface is based on Intuition, there  are
  498. keyboard  equivalents for practically anything you can do from gadgets
  499. or windows.  The  gadget  shortcuts  are  generally  indicated  by  an
  500. underlined  letter  in  the  text  of  the particular gadget, and will
  501. change from language to language.  For gadgets that cycle  or  scroll,
  502. the direction of movement will change based on whether the shortcut is 
  503. typed with  the  shift  key  pressed.  A few windows have gadgets with
  504. extra functions or non-text  gadgets  that  have  keyboard  shortcuts.
  505. Those  shortcuts  are  mentioned  in the this manual in the particular
  506. section relating to that gadet.  
  507.  
  508.           Menus also have keyboard shortcuts, which are always invoked 
  509. with the right Amiga key and a single letter pressed together.   These
  510. are indicated  in  the  menus,  in the normal Intuition fashion.  Note
  511. that these, too, can change  according  to  the  localization  of  the
  512. program, so the actual values aren't called out here.  
  513.  
  514.  
  515. 2.0 THE INPUT WINDOW 
  516.  
  517.           The Input Window is where a device is selected.  There are a 
  518. series  of gadgets and menu items that can control the way things work
  519. here.  The gadgets are as follows: 
  520.  
  521.      Device For Scan 
  522.           This list gadget displays a  list  of  recoverable  devices.
  523.           One of  these must be selected to run a scan.  These are all
  524.           listed  by  physical  AmigaDOS  name,  never  by  volume  or
  525.           assigned name.  
  526.  
  527.  
  528.  
  529. DiskSalv Version 2 Release 11.28                                Page 9
  530.  
  531.      FileSystem: 
  532.           This  gadget  is  a  cycle gadget that allows any of the six
  533.           aforementioned file systems to be selected.  When you select 
  534.           a device, this gadget will be set to DiskSalv's  best  guess
  535.           at  that  device's  file  system, or the default if DiskSalv
  536.           can't make a good guess.  Therefore, the  user  is  able  to
  537.           pick  a different one if DiskSalv didn't make a good choice.
  538.           See section 1.1, "FILESYSTEM", for a list  of  these.    The
  539.           "Best-Guess"  option  runs a special statistics tracking and
  540.           analysis routine to determine the most  likely  file  system
  541.           for any given device.  
  542.  
  543.      Mode: 
  544.           This  cycle  gadget  lets  the  user  select  an appropriate
  545.           recovery operation.  Interlocks are  managed  here  to  make
  546.           certain  that  the  specified operation and specified device
  547.           will work together.  See section 1.1, "MODE", for a list  of
  548.           the FileSystem names.  
  549.  
  550.      Set Filter...  
  551.           This  gadget  brings  up  the  "Disk  Scan  Filter  Options"
  552.           window.  This window allows various options  to  be  set  to
  553.           control  partial  scans  of  a  disk, exclusions by AmigaDOS
  554.           pattern name or protection bits, etc.  See section 2.1 for a 
  555.           full explanation of this window.  
  556.  
  557.      Device Info...  
  558.           This  gadget  brings  up  a  "Physical  Device  Information"
  559.           requester  which  gives  partitioning  and  other  low-level
  560.           information on the selected device.  
  561.  
  562.      Scan 
  563.           This gadget starts the disk analysis phase of  the  DiskSalv
  564.           program.   Once  the other phases are complete, the user may
  565.           return  to  the  Input  Window  without  having  to  restart
  566.           DiskSalv.  
  567.  
  568.           There  are  two  menus on the Input Window. One of these can
  569. call up a variety  of  miscellaneous  functions,  the  other  controls
  570. toggling  of a few control options, and the ability to save these back
  571. to the DiskSalv icon.  The mens are as follows: 
  572.  
  573.      Project/About...  
  574.           This item brings up a  requester  with  information  on  the
  575.           version   of   DiskSalv,   its  distribution  license,  some
  576.           Shareware data, and where to write me about DiskSalv.  
  577.  
  578.      Project/Help...  
  579.           This item brings up a requester with a brief explanation  of
  580.           the Input Window.  
  581.  
  582.      Project/Log File...  
  583.           This  item  brings up a file requester for the specification
  584.           of a log file.  This file must be on a device other than the 
  585.           input device.  When a log file is specified,  DiskSalv  will
  586.           write a record of its activity during all phases out to that 
  587.           file.  
  588.  
  589.      Project/Restore...  
  590.           This   item  brings  up  the  "Stream  Restoration  Options"
  591.           requester, which allows the user to specify input and output 
  592.           paths for restoration of a DiskSalv archive  file.    Please
  593.  
  594.  
  595. Page 10                               DiskSalv Version 2 Release 11.28
  596.  
  597.           see  section  3 for information on creating DiskSalv archive
  598.           files.  
  599.  
  600.      Project/Custom...  
  601.           This item brings up the "Custom Window". The  Custom  Window
  602.           is  an advanced option that can be used to search a disk for
  603.           logical  partitions  or  specify  partitions  based  on  the
  604.           low-level components.  
  605.  
  606.      Project/Save Device...  
  607.           This  item saves the currently selected "Device for Scan" as
  608.           a description file for the AmigaDOS Mount command.  
  609.  
  610.      Project/Load Device...  
  611.           This item loads a specified AmigaDOS device description file 
  612.           as a DiskSalv "virtual" device.  The name of the device will 
  613.           be the name of the description file.  
  614.  
  615.      Project/Quit 
  616.           This item closes the DiskSalv  program.    Its  function  is
  617.           identical  to  that of the Close gadget on the DiskSalv main
  618.           window.  
  619.  
  620.      Settings/DOS Lock 
  621.           The FileSystem (eg, AmigaDOS) is usually locked out from the 
  622.           input device during scan  and  recovery  operations.    This
  623.           option toggles  prevention  of such a lockout.  Fix-In-Place
  624.           operations are not affected  by  this,  as  they  absolutely
  625.           require  a  file system lockout since they are modifying the
  626.           input disk.  Note that allowing any writes to the input disk 
  627.           during a DiskSalv  operation  will  almost  certainly  cause
  628.           DiskSalv to malfunction.  
  629.  
  630.      Settings/Low Memory 
  631.           This option  toggles  low-memory mode.  If DiskSalv runs out
  632.           of memory on a system in normal mode, it may  be  successful
  633.           in low-memory  mode.    This automatically causes the chunky
  634.           allocator, file path buffer, and disk cache to go to minimum 
  635.           sizes.  It cuts out a number of other internal  things  that
  636.           generally just affect performance rather than success.  
  637.  
  638.      Settings/Small Window 
  639.           This option  toggles  automatic window sizing.  Normall, the
  640.           DiskSalv scanner will open a large window if  it  finds  the
  641.           current screen  supports  it.    This  will force use of the
  642.           small window for all scans, regardless of the screen size.  
  643.  
  644.      Settings/Quick Scan 
  645.           This option  selects  the  quick  scanning  option  for  the
  646.           scanner.   With  this  set,  the  scanning  process will run
  647.           faster by not displaying any data on the files  encountered.
  648.  
  649.      Settings/Save Settings 
  650.           This  options  saves  various  Input screen variables to the
  651.           DiskSalv tools icon.  
  652.  
  653.  
  654. 2.1 THE DISK SCAN FILTER OPTIONS WINDOW 
  655.  
  656.           The  "Disk  Scan  Filter  Options"  window  allows   several
  657. modifiers  to  be  set that affect the scan phase of a Recover-by-Copy
  658. operations.  These modifiers are ignored by  Fix-In-Place  operations,
  659.  
  660.  
  661. DiskSalv Version 2 Release 11.28                               Page 11
  662.  
  663. which must  examine  a disk in its entirety to perform correctly.  The
  664. window has standard "Ok" and "Cancel" gadgets, which  use  and  ignore
  665. the effect  of the current filter options settings, respectively.  The
  666. other gadgets are as follows: 
  667.  
  668.      File Pattern 
  669.           The string gadget takes in an AmigaDOS file pattern.  During 
  670.           the scan of a  disk,  any  file  matching  this  pattern  is
  671.           recorded, while any file not matching is ignored.  This acts 
  672.           on  links as well as files, but not on directories, since at
  673.           the time a directory is scanned, there's no way to  tell  if
  674.           it  will be needed by a child object that's further into the
  675.           disk.  
  676.  
  677.      Disk Scan Range 
  678.           This gadget is composed of two pointers, which can be  moved
  679.           to  modify  the  part  of  the  input  disk that is actually
  680.           scanned.  The start and finishing blocks on  that  disk  are
  681.           indicated next  to  the gadget.  The gadget is hard-wired to
  682.           make certain that  the  start  of  the  disk  is  below  the
  683.           finish.   This  can be moved from the keyboard with left and
  684.           right cursor keys, unshifted or shifted.  
  685.  
  686.      Protection Bits 
  687.           This is a group of gadgets which control  matching  of  each
  688.           file  encountered against the seven defined protection bits.
  689.           A "Don't Care" setting matches  any  level,  a  "Match  Set"
  690.           setting  matches  a  bit  that's logically set, and a "Match
  691.           Clear" setting matches a bit that's logically clear.  
  692.  
  693.  
  694. 2.2 THE CUSTOM WINDOW 
  695.  
  696.           The Custom Window is a fork  off  the  main  DiskSalv  Input
  697. Window that is used for dealing with special device cases.  An unknown 
  698. disk,  a  disk  with  lost  partitioning  information,  or  other such
  699. problems can  be  solved  here.    An  input  device  is  entered  via
  700. exec-level device  name  and  unit  number.   The user can specify the
  701. partitioning  information  or  ask  DiskSalv   to   go   looking   for
  702. partitions.   In  a  search,  the  partition's  logical  name  can  be
  703. specified as a search target, or DiskSalv can be  instructed  to  find
  704.           all partitions on the disk.  There are fifteen gadgets here: 
  705.  
  706.      Create 
  707.           The  Create  gadget builds one "virtual device" based on the
  708.           information supplied  here.    This   requires   the   basic
  709.           partitioning  information,  exec device name and unit, and a
  710.           DOS Name which  is  used  in  the  "Device  For  Scan"  list
  711.           gadget.   Any  such virtual device is listed in parentheses,
  712.           and only the "Salvage" operation can be used on them.  
  713.  
  714.      Search 
  715.           This function starts a search on  the  given  disk  for  one
  716.           volume that matches the given pattern.  
  717.  
  718.      Analyze 
  719.           This function starts a scan of the defined range of the disk 
  720.           for any  partitions.   The base block of a partition will be
  721.           used as its name if no root is found.  If a root  is  found,
  722.           its  name  will  be  used  instead  in the "Device For Scan"
  723.           list.  
  724.  
  725.  
  726.  
  727. Page 12                               DiskSalv Version 2 Release 11.28
  728.  
  729.      Cancel 
  730.           Leave this window without performing any kind of scan.  
  731.  
  732.      Device Name: 
  733.           This is the Exec device used to manage  the  disk,  such  as
  734.           "scsi.device".  Be very careful in selecting this properly.  
  735.  
  736.      Name/Pattern: 
  737.           This  is  a  DOS Name for "Created" volumes, or a pattern to
  738.           apply to a search for a specific volume or as a  volume-name
  739.           filter for full analysis.  
  740.  
  741.      Unit: 
  742.           The  unit number for the Exec device names in "Device Name".
  743.           Be very careful in selecting this properly.  
  744.  
  745.      Sectors/Track: 
  746.           This is the number of sectors assigned per disk track.  
  747.  
  748.      Bytes/Sector: 
  749.           This is the basic block size for the  device.    While  most
  750.           things  in the system are set up for 512 byte blocks, larger
  751.           disks may  use  larger  block   sizes.      These   are   in
  752.           powers-of-two, 512 bytes or larger.  
  753.  
  754.      Sectors/Block: 
  755.           This  parameter  allows  for a variable effective block size
  756.           per  partition  while  having   a   consistent   number   of
  757.           bytes/sector throughout a disk.  Block size is Sectors/Block 
  758.           * Bytes/Sector. By default, this is only available under V39 
  759.           or later file systems.  
  760.  
  761.      Low Sector: 
  762.           This  is  the  starting  position  on the input device to be
  763.           searched.  Since we're not searching a logical partition but 
  764.           in fact a physical disk, this number is a direct disk sector 
  765.           number (this specifies the physical block to map to  logical
  766.           block 0 for the Create operation).  
  767.  
  768.      High Sector: 
  769.           This is the last physical block to scan for all operations.  
  770.  
  771.      Flags: 
  772.           These are device-driver specific flags.  
  773.  
  774.      Memory Type: 
  775.           This  cycle  gadget  allows  the user to specify the type of
  776.           memory to use for disk  buffers.    Types  include  DEFAULT,
  777.           CHIP, FAST, and DMA-24.  
  778.  
  779.           There are only two menu items on the single menu attached to 
  780. the Custom Window. The first is the "Project/Help..." item, which pops 
  781. up  a  requester  box  describing the Custom Window. The other item is
  782. "Project/Quit", which will terminate the DiskSalv program.  
  783.  
  784.  
  785. 3. THE SCAN WINDOW 
  786.  
  787.           The Scan Window is entered once the user selected  the  Scan
  788. gadget  of the Input Window. In normal operation, the Scan window will
  789. have two gadgets, two menu items,  and  four  informational  displays.
  790. The "Stop"  gadget  will  cause the scan to stop where it is.  This is
  791.  
  792.  
  793. DiskSalv Version 2 Release 11.28                               Page 13
  794.  
  795. only available  for  Recover-by-Copy  operations,  since  Fix-In-Place
  796. operations need  to  scan  the  entire  disk.  The other gadget is the
  797. "Pause" gadget, which will freeze the scan where it is until  told  to
  798. go on.  
  799.  
  800.           The two menu items are "Project/Help..." and "Project/Quit". 
  801. The  former will display some information about the Scan Window, while
  802. the latter will cause the DiskSalv program  to  quit,  just  like  the
  803. Close gadget  will.  During Fix-In-Place operations, the Quit function
  804. will take some time if  invoked  during  some  of  the  latter  fixing
  805. phases,   since   DiskSalv  doesn't  want  to  leave  the  disk  in  a
  806. questionable state.  
  807.  
  808.           The "Current Operation" display indicates what  DiskSalv  is
  809. actually doing  at  any  given  time during the scan.  To the right of
  810. this  is  the  "Device  Scan"  box,  which  keeps  track  of  scanning
  811. statistics,  like  the  current  block  and  number of Files or Errors
  812. encountered.  Below this is the "fuel guage", which is always used  to
  813. indicate the  progress  of  the  current  phase.    Below  that is the
  814. "Scanning Results" display, which indicates the type and name of  each
  815. object found, as well as other statistics (this is basically what gets 
  816. written out  to  the  log  file,  if there is a log file).  On a large
  817. display, this is eleven lines long, on a small display its five  lines
  818. long.   The  QUICKSCAN  option  eliminates  this  part  of the display
  819. altogether.  
  820.  
  821.  
  822. 4. THE OUTPUT WINDOW 
  823.  
  824.           All Recover-by-Copy operations and  Fix-In-Place  operations
  825. with  corrupt  files  end  the  scanning  process  and open the Output
  826. Window. This is where objects and the output path are selected  for  a
  827. Restore (eg,  Recover-by-Copy)  operation.  This window's GUI consists
  828. of twelve gadgets and ten menu items.  The gadgets are as follows: 
  829.  
  830.      Salvage File List (etc) 
  831.           The scrolling file list, labelled somewhat  differently  for
  832.           each  function,  is where files are selected for restoration
  833.           to a new volume.  Clicking on a  file  or  link  alternately
  834.           tags  or  clears  that  object,  and  makes it the "current"
  835.           object  (displayed  in  the  text  gadget  below  the   list
  836.           gadget).   Clicking on a directory once makes it the current
  837.           object, but does not tag it.  Clicking again  on  that  same
  838.           directory   causes   this   "browser"   to  "move"  to  that
  839.           directory.  There are keyboard shorts for  this  too.    The
  840.           standard gadget short (shown in the list title), will scroll 
  841.           the  selected  item  in  the  list,  but  won't  actually do
  842.           anything with it.  The space bar will  toggle  selection  of
  843.           file objects, or enter directories.  
  844.  
  845.      Output Path 
  846.           This  specifies two gadgets, a disk icon gadget and a string
  847.           gadget.   Clicking  on  the  disk  icon  brings  up  a  file
  848.           requester,  while  clicking on the string requester lets the
  849.           user enter a path by hand.  This path is the  place  to  put
  850.           any recovered  files.    It  can  be a device, directory, or
  851.           possibly  a  "stream",  depending  on  the  setting  of  the
  852.           "Archive Stream"  option.    If  a non-existant directory is
  853.           specified, it is created.  
  854.  
  855.      Salvage 
  856.           This gadget begins  the  file  restoration.    It  won't  be
  857.  
  858.  
  859. Page 14                               DiskSalv Version 2 Release 11.28
  860.  
  861.           selectable until at least something is tagged in the Salvage 
  862.           List and proper output device parameters have been entered.  
  863.  
  864.      File List Action 
  865.           The  remaining  gadgets  are  part  of  the File List Action
  866.           group.  These control tags on objects,  browser  navigation,
  867.           and other  aspects  of the file list.  Note that only tagged
  868.           files are operated on by "Forget" or "Salvage".  
  869.  
  870.      Parent 
  871.           This gadget brings the file  browser  up  by  one  directory
  872.           level.  
  873.  
  874.      Root 
  875.           This  gadget  brings the file brower up to the top directory
  876.           level.  
  877.  
  878.      Forget 
  879.           This gadget removes any  tagged  objects  from  the  browser
  880.           list.  It has no effect on the object as it exists on-disk.  
  881.  
  882.      Info...  
  883.           Statistics  on  the  "current"  object  are  displayed  in a
  884.           requester when this is selected.  
  885.  
  886.      Select Directory 
  887.           This will recursively tag every object in the hierarchy of a 
  888.           directory.  If the current object is a directory, it's used, 
  889.           otherwise the present (displayed) directory is used.  
  890.  
  891.      Select Files 
  892.           Like "Select Directory", but tags only files.  
  893.  
  894.      Clear Directory 
  895.           Like "Select Directory", but recursively untags objects.  
  896.  
  897.      Clear Files 
  898.           Like "Clear Directory", but untags only files.  
  899.  
  900.           Most of the menu items are designed to support the  settings
  901. of different restore-time parameters.  The menu items are: 
  902.  
  903.      Project/Help...  
  904.           This  option  pops up with a brief description of the Output
  905.           window.  
  906.  
  907.      Project/New Device...  
  908.           This option resets DiskSalv and  starts  over  back  at  the
  909.           Input Window.  
  910.  
  911.      Project/Quit 
  912.           This  option,  like  the  close  gadget,  causes DiskSalv to
  913.           cleanly exit.  
  914.  
  915.      Settings/Size Check 
  916.           This toggles automatic size checking of the  output  volume.
  917.           Normally,  DiskSalv watches the size of the output volume to
  918.           have an idea ahead of time that a volume will fill up.  Some 
  919.           devices, such as RAM:,  are  dynamically  sized  and  always
  920.           indicate  full  when  asked,  so  this  parameter  is mainly
  921.           intended for such devices (DiskSalv  actually  invokes  this
  922.           automatically  for  RAM:,  but it would have to be specified
  923.  
  924.  
  925. DiskSalv Version 2 Release 11.28                               Page 15
  926.  
  927.           manually for other such devices).  
  928.  
  929.      Settings/Warning Notes 
  930.           This toggles whether or not DiskSalv will attach  a  warning
  931.           or error message, as a FileNote, to any file it restores via 
  932.           a  Recover-by-Copy  operation  that  it considers suspect or
  933.           bad.  
  934.  
  935.      Settings/Notes Restored 
  936.           This  toggles  restoration  the  original  FileNote  to  any
  937.           restored object.    Warning  notes  will  override  original
  938.           notes).  This option will inhibit such an action.  
  939.  
  940.      Settings/Protection Restored 
  941.           This toggles restoration of the original protection codes on 
  942.           any object.  This option will inhibit such an action.  
  943.  
  944.      Settings/Date Restored 
  945.           This toggles restoration of the original  AmigaDOS  date  to
  946.           all output objects.  
  947.  
  948.      Settings/Archive Stream 
  949.           This  determines  which I/O formation is used for the output
  950.           device.  By default, the OUTPUT device is a  directory,  and
  951.           DiskSalv  regenerates  the specified directory tree as found
  952.           on the input  disk.    When  Archive  Stream  mode  is  set,
  953.           DiskSalv  writes  out  everything  in  a  structured  output
  954.           stream.  This stream is turned back to a directory  tree  by
  955.           using  the Project/Restore option on the Input Window. Since
  956.           this formatted stream makes all disk  objects  appear  as  a
  957.           single  file,  it  can be piped though compression tools and
  958.           processed through other interesting programs as desirable.  
  959.  
  960.      Settings/Save Settings 
  961.           When selected, this saves the state of  the  toggle  options
  962.           other than "Archive Stream" out to the DiskSalv.info file.  
  963.  
  964.  
  965. 5. THE RECOVERY WINDOW 
  966.  
  967.           The  Recovery  Window  looks  exactly  like the Scan window,
  968. mainly because it is the Scan Window just doing something else.   This
  969. window  displays  each  file  as  it's  restored to the output device.
  970. Along the way, if the output device fails or gets full, DiskSalv  will
  971. prompt  the  user  to  skip  the  file,  change  the  media, or change
  972. devices.  When a device change is  requested,  the  Output  window  is
  973. called up  again to secure a new device input the normal way.  At that
  974. point, only files left yet-to-be restored will be out on disk.  
  975.  
  976.  
  977. 6. LICENSING AND DISTRIBUTION 
  978.  
  979.           This program is distributed as ShareWare. It may  be  freely
  980. redistributed,  but  no  charges  other  than  reasonable  copying and
  981. handling fees may be collected.  The suggested basic registration  fee
  982. is US$10, which gets you an entry in my database of users.  
  983.  
  984.           The  commercial version offer has changed somewhat since the
  985. last ShareWare release of  DiskSalv.  Hopefully  everyone  (especially
  986. those who  have  already  sent in money) will be happy with this.  The
  987. price is still US$40 (see the price list for foreign  postage).    The
  988. release will  not  be in August of 1993, which has come and gone.  The
  989.  
  990.  
  991. Page 16                               DiskSalv Version 2 Release 11.28
  992.  
  993. reason for this is that, contrary to the previous  announcement  ("the
  994. commercial  and  shareware versions of the program are the same"), the
  995. commercial program will actually be something called DiskSalv 3.  This
  996. package,  which  will  be  available  by  the end of 1993, at least in
  997. pre-release form, contains the enhanced DiskSalv  3  (please  see  the
  998. DiskSalv 3 data sheet if you can print out PostScript), the AmigaGuide 
  999. manual, and the printed manual.  
  1000.  
  1001.           Finally,  if  you  want an update service, for an additional
  1002. US$10 (US$15 foreign) you get a year's  worth  of  updates,  at  least
  1003. two.   If  no  bug  fixes  are  done  during  that time, you'll get an
  1004. enhanced version when it is released.  This is mainly  to  keep  those
  1005. concerned about any bugs fed with the latest version automatically.  
  1006.  
  1007.           The  place to send any and all inquiriess, bug reports, etc.
  1008. is: 
  1009.                     Dave Haynie
  1010.                     284 Memorial Avenue
  1011.                     Gibbstown, NJ 08027
  1012.                     USA
  1013.  
  1014.                     You can also contact me electronically:
  1015.                               UUCP:    daveh@cbmvax.commodore.com
  1016.                               Usenet:    {uunet,rutgers}!cbmvax!daveh
  1017.                               BIX:        hazy
  1018.                               Portal:        hazy
  1019.                               FAX:        +1 (609)224-0442
  1020.  
  1021.           If you're not from the  USA,  you  can  pay  in  your  local
  1022. currency if  you  send  a  cash  equivalent.  The extra expense of you
  1023. getting a  draft  for  US  currency,  then  me  paying  the  bank  for
  1024. collection, seems to leave the banks getting about 1/2 the money for a 
  1025. US$10 registration  fee.  You can get US fund checks in some countries
  1026. that go through just fine, these are generally  drawn  on  banks  with
  1027. some  exchange  agreement  going  with your local bank, those are fine
  1028. too.  I'm not trying to sound greedy here by any means, I just  prefer
  1029. either  you  or I get that $10 or so, not the banks, even if I need to
  1030. go to the city and convert the cash myself once I collect a reasonable 
  1031. amount.  Of course, if your country's laws prohibit sending  cash  out
  1032. of the country or something similar, you may not want to do this.  
  1033.  
  1034.           Also   of  interest  to  foreign  Amiga  users  is  language
  1035. support.   DiskSalv  fully  supports  the  AmigaDOS  2.1  localization
  1036. library mechanism.    Some  locale  catalogs  are  included  with this
  1037. initial release.  Additional locale support should be available  at  a
  1038. later date.    Translations  of the commercial manual may be possible,
  1039. but none are currently being developed.  
  1040.  
  1041.           If you're a commercial interest, you can  contact  me  about
  1042. non-exclusive bundling  deals  if you're interested.  Dealers or other
  1043. groups  should  contact  me  about  volume  discounts  on  the  deluxe
  1044. distribution.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.